EDITOR MANUAL

Please advise one of the Admin Admin and PM Rick, we will welcome your help. Even small edits, corrections and improvements, as you see them, are very effective.

We need Users to become “Editors” of the OpenCPN Books. The current focus is:

• Plugin Documentation - Pick one you like, put your name on it and do it!
• Dev Manual,Plugin Compiliation Procedures needed

We need Users to become “Managers” of these Books:

• Supplementary Hardware
• Supplementary Software

Mike R. [Rasbats] has reorganized and improved the Developer Manual and needs a partner Manager, who has plugin programming experience, preferably. Please PM Rick or PM Mike.

OpenCPN Programming
You would marvel at strength of the programming team and the steady stream of OpenCPN improvements, if you were to register on OpenCPN Github & Plugins.

User Contribution
Consequently User's are primarily responsible for maintaining and improving the Wiki. We depend on everybody's help and contributions to keep these Books current.

Please advise one of the Admin and PM Rick, we will welcome your help. Even small edits, corrections and improvements, as you see them, are very effective.

Editor Policies have changed. USERs can no longer register themselves, we now have manual registration by the ADMIN for EDITOR's who must be qualified and known contributors.

After all of our work migrating the wiki, we have no interest in repairing the wiki or restoring randomly deleted pages. Even with user Tracking and the “Recent Changes” and “Old Pages” buttons, it's too much trouble.

We want our Editors to have good intentions! Therefore Editors will have to demonstrate:

1. They know and use OpenCPN. Another Editor recommendation or demonstrated by actions.
2. Are responsible members of the forum for some period of time.
3. Explain what skills and interests they can bring to the task.
4. If there is any hesitation, the answer may be we don't know you, be lets see what you do.

Nefarious activity will result in deletion of your user account.
Editors please report questionable activity immediately. We are always looking for volunteer help, but it must be the right kind of help!

1. Backed up each night, full site retrieval or file by file. 15 days of backup.
2. Recent Changes & Old Page Retrieval from the Attic, including deleted pages.
3. Tracing of Editor activity.

←— For instructive Editing pages Under Editors Manual and see HTML Migration

1. User Tools Dropdown on upper right: has Admin, Media Manager to upload images, Recent Changes, Old Pages.
2. Search box and User Profile upper right. Also use the Editor Manual pages to the left to learn more.
3. Two Editors DW Edit for normal native format editing & CKG Edit for migration of HTML.
4. To edit an Existing Dokuwiki page use DW Edit (Right margin second button from bottom). A Dokuwiki Format Syntax link is at the top of the page.
5. In DW Edit open on an Owiki page you will see {{indexmenu_n>(sort_number)}} above the title. Please leave this in place as it defines the sort order of namespaces in the Left Indexmenu.
6. Indexmenu Plugin uses the page Title in the Left Navigation Menu, make it short! The page “pathname: should be the same as the title but using all lowercase and instead of spaces use “_”. The precise pathname and format makes a difference. Indexmenu uses a hidden “opencpn:sidebar” page, where the definition for the TOC is made.
7. Use full pathnames. eg: [[opencpn:opencpn_user_manual:getting_started]] For a test See Test Pathnames . Also use ”:“ in place of ”/“ or “\”.
8. To migrate HTML text into a new page first Create a New Page in the correct path location. Please be careful with your pathnames when creating a new page. I usually browse to the parent URL technique shown in Create a New Page. If Left Indexmenu has a Page Icon and does not sort correctly read No Blue Dot or Fix new page sorting. Then after the page is created, use CKG Edit (Right Margin top), Paste the HTML, Save & then use DW Edit Mode (preferred). See the notes on Migration for more step by step detail.
9. If you make a mistake and want the previous version of a page, see Recent Changes Read there about Old Changes to individual pages and Attic. I like Old Changes best.
10. Don't Move pages without a good reason or without fixing all links in the entire document (a big job).
11. Alternatively use the Move Plugin carefully, leaving time for it to work on changing all the links, then check the links.
12. Don't delete pages without a good reason. There is deletion tracker and an Attic to retrieve Recent Pages, but be cautious deleting.
13. Use Media Manager to Upload Files and Upload Screenshots. Note that all screenshots should have resolution less than (550 x 550). It really does matter where the media files are uploaded. See Media Manager for the designated locations. Sorry, but I will simply be deleting all stray screenshots and not tracing them out!
14. Finally you will want to Insert Screenshots that you've uploaded into your page.
15. Create Screenshots provides some suggestions for making screenshots.
16. If you can't fix something, leave a FIXME (in Smilies button at the top) With a note & your name, you can use the signature icon — Rick Gleason 2017/01/17 17:05 and PM one of the other Editors.
17. Don't duplicate work, use the Summary of Progress to let the Team know what you've done, beginning & end if its a block of work, so others know where to start!

←–Use the Editor's pages in the Left menu.

Try to Edit down as “Less is more”
That's about it.
Welcome to the Team.

Just Learned how to “Create Media Directory” it's very similar to “Creating a new page from the URL” (See “No blue dot”) (be careful to note that you are pointed in the correct path please!)

Moving a page's location which changings the “pathname”, automatically BREAKS LINKS in the document. These links are NOT automatically repaired. You must then check every page link in the WHOLE document. The last time I did this it took 2 days!!

So, the RULE is:
Do NOT move pages, unless you are prepared to find each and every link in the ENTIRE document that uses that page's old pathname, and repair it!

If you must move a page it helps to know:

• Dokuwiki search function at the top can help you find each page that attempts to link to the page you are editing.
• If you search for the original pathname the search function will return a list of pages which attempt to link there.
• Edit each of them, replacing the original pathname with the new one.

Alternatively, you can try the MOVE PLUGIN, but check links afterwards please.

The main migration from Druple6 is completed.

• File Structure
• Migration Process
• Druple to Dokuwiki

• OpenCPN Drupal 6 (old) website May be a redirect to the new site.
• Owiki Dokuwiki (updated)